EMP 移轉指令列公用程式
在這個部分中:
關於 EMP 移轉指令列公用程式
「Environment Manager 個人化移轉指令列公用程式」(EMP 移轉指令列公用程式) 是一款指令列導向的工具，其允許將使用者資料從來源資料庫複製至目標資料庫、將使用者名稱對應至目標網域，以及相應調整儲存的登錄設定。該公用程式會直接聯繫各自的資料庫且不會使用現有的個人化伺服器。EMP 移轉指令列公用程式提供了與 EMP 移轉公用程式相同的功能。
「EMP 移轉指令列公用程式」位於 Tools 安裝資料夾內，而且是透過命令提示字元執行。
執行 EMP 移轉指令列公用程式
- 開啟「執行」對話方塊並輸入 cmd.exe。
- 使用命令提示字元以導覽至 Tools 安裝資料夾: %ProgramFiles%\AppSense\Environment Manager\Tools\
- 執行 EMPMigrateCmd.exe 並搭配適當參數，如下表所詳述。
EMP 移轉指令列公用程式參數
| 參數 | 輸入引數 | 參數詳細資訊 |
/?
/ |
n/a | 將說明文字輸出至控制台。 |
/sourcedb
|
dbname | 來源資料庫的名稱。 此為必要參數 |
/sourceinstance
|
server[\\instance] | 來源資料庫的伺服器或執行個體名稱。執行個體名稱為選用。 此為必要參數。 |
/targetdb
|
dbname | 目標資料庫的名稱。 |
/targetinstance
|
server[\\instance] | 目標資料庫的伺服器或執行個體。執行個體名稱為選用。 此為必要參數。 |
/sourcewindowsauth
|
true 或 false | 用於連接至來源資料庫的驗證類型:
若未指定此引數，則會自動使用 Windows 驗證。 |
/sourcesqlusername
|
username |
來源資料庫上 SQL 驗證的使用者名稱。若需要 SQL 驗證，將 sourcewindowsauth 參數設定為 false。 |
/sourcesqlpassword
|
password |
來源資料庫上 SQL 驗證的密碼。若需要 SQL 驗證，將 sourcewindowsauth 參數設定為 false。 |
|
|
true 或 false | 用於連接至目標資料庫的驗證類型:
若未指定此引數，則會自動使用 Windows 驗證 |
/targetsqlusername
|
username |
目標資料庫上 SQL 驗證的使用者名稱。若需要 SQL 驗證，將 sourcewindowsauth 參數設定為 false。 |
/targetsqlpassword
|
password |
目標資料庫上 SQL 驗證的密碼。若需要 SQL 驗證，將 sourcewindowsauth 參數設定為 false。 |
/domainmapping
|
[current]|[map]|[nomap] |
要為使用者套用至新網域的對應類型。若未指定，則此參數會預設為 current。 |
/mapto
|
domainname |
mapto 參數設為 map 時的目標網域名稱。 |
/users
|
[all]|[group]|[list] | 指定要移轉哪些使用者:
若在來源資料庫中找到重複的使用者，僅會移轉最新的使用者。 |
/usersgroup
|
groupname |
要移轉之個人化群組的名稱。當使用者設定為 group 時使用。 |
/userlist
|
listfile | 內含要移轉的使用者清單的檔案完整路徑。當使用者設定為 list 時使用。 檔案路徑必須加上引號。檔案內列出的各個使用者必須各自為一行，或採用 CSV 格式。 若指定的檔案名稱並無路徑，則會視為存在於 EMPMigrateCmd.exe 工作目錄內。 |
/options
|
[replace],[ignoreglobal],[copyarchives],[copydiscovered] | 可透過逗號分隔參數的方式指定其中一個或多個選項:
|
/output
|
outputfile | 報告檔案的輸出位置。指定輸出路徑時，路徑名稱必須加上引號。若尚未指定路徑，會使用預設路徑 %USERPROFILE%\\Documents\\EMPMigrate.log。 |
/threads
|
number |
移轉資料時使用的執行緒數目。值 0 會強制讓使用的執行緒數目等於處理序計數，並會做為預設值。 |
使用者名稱的所需格式
使用者名稱必須符合來源資料庫內的 dbo.User.Name 欄位。其採用 Microsoft 所定義的下層登入名稱格式。例如，使用者的格式為 ExampleUser，而在本機網路 Ivanti.local 為 Ivanti\ExampleUser。使用完整的 Ivanti.local 網域名稱會導致使用者被略過而不會移轉。雖然就技術層面而言是正確的，但它並未對應至資料庫中所指定的「名稱」欄位。
不支援使用者主體名稱 (UPN) 格式。
使用方式情節和解決方案
以下情節示範了 EMPMigrate 指令列公用程式的使用方式。就這些情節而言，SrcSql 代表來源位置，而 TgtSQL 則為目標目的地。每種情節均包含了待完成工作的概述，然後是指令列解決方案。
狀況一
使用 Windows 驗證時，您需要將名為 Prod Users 的個人化群組移轉至新的目標位置，並使用來源資料庫的使用者的資料取代目標資料庫內現有使用者的資料。如要移轉群組，您必須檢查個人化群組是否存在於您的目標位置上，並檢查全域資料設定中是否並無差異。
解決方案
EMPMigrateCmd.exe /SourceInstance SrcSQL /SourceDB PSDB /TargetInstance TgtSQL /TargetDB PSDB /Users Group /UserGroup "Prod Users" /Options Replace
狀況二
同時對來源和目標位置使用外顯 SQL 認證時，您需要將所有使用者移轉至目標位置。移轉必須取代現有的個人化群組，忽略所有全域資料差異，但不可對應至新的網域。
解決方案
EMPMigrate.exe /SourceInstance SrcSQL /SourceDB PSDB /SourceSQLusername sa /SourceSQLPassword sourcePass /TargetInstance TgtSQL /TargetDB PSDB /TargetSQLUsername sa TargetSQLPassword targetPass /DomainMapping NoMap /Users All /Options Replace,IgnoreGlobal
情節三
在來源位置使用 Windows 驗證時，您需要將在 c:\Temp\UserList.txt 中找到的使用者清單移轉至需要外顯 SQL 認證的目標位置。移轉必須取代現有的個人化群組，並包含搜尋到的應用程式的資料。其必須忽略全域資料設定內的任何差異，但不可對應至新的網域。
解決方案
EMPMigrate.exe /SourceInstance SrcSQL /SourceDB PSDB /TargetInstance TgtSQL /TargetDB PSDB /TargetSQLUsername sa /TargetSQLPassword targetPass /Users List /UserList "c:\Temp\UserList.txt" /Options Replace,IgnoreGlobal,CopyDiscovered